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START UP 


Check the cable linking the computer to the monitor (RGB port to input port), 
or to the television (UHF out to aerial socket). Check the power to the 
computer and monitor or tv screen. Check that the computer is switched on and 
that the monitor or tv is on. 


The message: 


BBC Computer 32K or BBC Computer 32K 
BASIC Acorn DFS 

> BASIC 

EN > 


should be displayed. 


At this point the computer will be in mode 7 (teletext mode) ready for general 
use. The CAPS/LOCK key will be on because all commands to the computer must 
be in capital letters. 


LOADING, SAVING, AND RUNNING PROGRAMS 


On BBC Models A and B the default storage is tape. To use disk storage, type 
*DISK. 


On the Model B Acorn DFS with default storage disk, type *TAPE to use tape 
storage. 


The ESCAPE key allows you to leave cassette or disk operations at any point. 


Loading a program from tape into the computer’s memory 


1) Insert the cassette into the tape recorder with the program side 
uppermost. 


2) Check that the volume and tone controls are correctly set on the tape 
recorder, approximately 6 and IN respectively. 


3) Type LOAD"<filename>" and press RETURN, for example LOAD"WAGES". 


4) The message ‘Searching’ will be displayed. Fast wind the tape either to 
just before the known start of the program on tape, or the beginning of 
the tape, press the PLAY button on the cassette recorder, and then press 
RETURN. When the computer finds the named program it will display 
‘Loading’ and when the load is complete the > prompt will appear. 


LOAD" instead of LOAD"<filename>" will load the first program that the 
computer finds on tape. 


5) Type RUN and press RETURN to use the program. CHAIN"<filename>" or 
CHAIN" will load and also run the program. 


Loading a program from disk 


1) 


2) 


3) 


4) 


5) 


Hold the disk at the label edge with the label facing upwards. For a 
single CUMANA drive unit, insert the disk into the drive unit and move the 
lever to the down position. For a double CUMANA drive unit, insert the 
disk into drive Ø, which will be positioned to either the left or the top 
of the pair of drive units, move the lever down, and set the switch to 40 
or 8@ depending on whether it is a 4@ or 86 track formatted disk. All 
single drive units use a 49 track format, the double units can be either 
4D or 86. 


Type LOAD"<filename>" and press RETURN, for example LOAD"WAGES". When 
loading a program from disk the filename must be specified. 


When the load is complete the > prompt will appear. 


Type RUN and press RETURN to use the program. CHAIN"<filename>" will load 
and also run the program. 


To release the disk, turn the lever to the up position. 


Some disks have a BOOT file on the disk. To use the BOOT file to load and run 
programs see Section 12 of this document. 


Saving the current program on tape 


1) 


2) 


3) 


4) 


5) 


6) 


7) 


Insert the cassette into the tape recorder. 


Check that the volume and tone controls are correctly set on the tape 
recorder, approximately 6 and 1 respectively. 


Type SAVE"<filename>", where <filename> is the chosen filename of up to 1 
characters, and press RETURN. 


The message "RECORD then RETURN" will be displayed. Rewind or forward 
wind tape to position for start of saving program. 


Press the RECORD and PLAY buttons down on the cassette unit and then press 
RETURN on the BBC micro. 


While the program is being copied to tape the name of the program and 
numbers will be displayed. When the save is complete the > prompt will 
appear. 


*CAT can be used to verify that the program has been saved. The *CAT 
command will try to read the saved program back without destroying the 
program held in memory. 


Saving the current program on disk 


Refer to Section 12 for information on formatting disks for either single or 
double density use, drive and directory specification. 


1) 


Insert a previously formatted disk into drive @ of the drive unit and when 
it clicks into position close the drive door. The disk may already hold 
previously saved programs. 


2) Type SAVE"<filename>" and press RETURN. The filename may consist ofa 
maximum of 7 characters but must not include any of the following: 


# * . : or embedded spaces 
The red drive light will glow while the program is being saved. 
3) Type *CAT to check that the file has been saved. 


4) To release the disk, press lower half of the door inwards and the disk 
will pop out. 


Running a program 


When a program has been either typed in, or loaded into memory from tape or 
disk, the computer can be made to execute the program by typing the command 
RUN and pressing RETURN. 

FUNCTION OF SOME OF THE SPECIAL KEYS 


Where appropriate, the keys repeat if held down. 


Key Function 

RETURN Signals end of input line. Must follow every command, 
statement or data entry. 

DELETE Erase last character. Repeats if held down. 

COPY Used in conjunction with cursor control keys. Copies the 


character under the flashing cursor to the copy line. 
CTRL Used in conjunction with other keys to initiate special action. 


ESCAPE Stops a program running. Can be programmed to move from one 
part of a program to another. 


BREAK Soft resets computer but allows retrieval of existing program 
by typing OLD and pressing RETURN. Does not reset the clock, 
clear user-defined keys, or destroy the values of resident 
integer variables A% to 2%. Returns computer to mode 7. 


TAB Used under special circumstances such as word processing. 


STE Press any of these keys to enter EDIT mode. A block cursor 
marks the writing position on the screen. Move flashing cursor 
to editing position, press COPY key to move character under 
flashing cursor to line being written. 


CAPS/LOCK Gives capital letters and lowercase symbols, e.g. ABC; :. 
Press again to release. Has own ON/OFF light. 

SHIFT/LOCK Gives capital letters and uppercase symbols, e.g. ABC + *, 
Press again to release. Has own ON/OFF light. 

fø to f9 User-definable function keys which will store one or several 
words. 


The following keys generate ASCII characters in modes Ø to 6 and teletext 
display characters in mode 7. 


Mode 7 Modes @ to 6 
teletext ASCII 


m 


raise to a power 


delimit machine code section in program 


— mn $ ¢ su > al 


{| is the CTRL character 
iM inserts RETURN into user definition of 
red function keys. 


VARIABLES, NUMERIC ACCURACY AND RANGE 


All variable names can contain as many characters as required and all 
characters are used to identify the variable. A variable name must start with 
a letter and must not start with a BASIC keyword. 


Integer variables are denoted by % at the end of the name, and string 
variables by $ at the end of the name. Arithmetic is performed faster with 
integer variables. The integer variables A% to Z% are special in that they 
are permanently allocated space in memory; they are called resident integer 
variables. If values are assigned to any of these variables they carry over 
from one program to another. The commands NEW, CLEAR, or RUN, or pressing the 
BREAK key, will not destroy values set in the resident integer variables, but 
switching off the computer will do so. 


Name NAMES NAME$ 


Range from S -2147483648 255 chars 

to + "32147483648 J 
Accuracy 9 sig figs 1 digit - 
Stored in 4B bits 32 bits ASCII values 


Real, integer, and string array variables are also available; the naming 
convention is the same as the simple variables. 


ARITHMETIC OPERATORS i 
Order of precedence is shown by the following group order, group 1 taking 
precedence over group 2 etc. The operators in any one group have equal 
priority and are dealt with on a left-to-right basis. 


Group 1 Unary minus Group 4 
Unary plus 
NOT 
Functions :| Group 5 
Brackets ( ) 
Indirection operatorst 


Group 6 


Group 7 


+Indirection operators are a more flexible variation of PEEK and POKE used for 
reading and writing to memory. 


INPUT FROM THE KEYBOARD 

INPUT 

The INPUT command outputs a ? prompt and waits for string or numeric data as 
specified to be keyed in until the end of input is signalled by pressing the 


RETURN key. If numeric data is expected, a non-numeric character will return 
the number up to the invalid character only. A comma is used to separate data 


items so cannot be input as part of a string variable. Leading spaces are 
ignored. 

Example Pur po se 

16 INPUT A Expects number from keyboard. ? prompt. 

1@ INPUT A$ Expects string from keyboard. ? prompt. 

19 INPUT"CODE" , A Prints message 'CODE' followed by ? 

19 INPUT"CODE"A ? prompt is suppressed if comma omitted. 

19 INPUT A, A$ Expects number followed by string. Separate items 


input by comma or carriage return. 
INPUT LINE 


The INPUT LINE statement can be used in the same way as INPUT but it will 
accept everything that is typed including leading spaces and commas. 


18 INPUT LINE"NAME" , A$ 
GET and GET$ 


The GET and GET$ functions wait for a key to be pressed. 


19 A$=GET$ Returns the character pressed in A$. 
19 A=GET Returns the ASCII value of the character pressed in 
A. 


INKEY and INKEYS 


INKEY and INKEY$ function as GET and GET$ except that they only wait a 
specified time for a key to be pressed. If a key is not pressed in that 
period then the program continues executing from the next line with value -1 
for INKEY and "" for INKEY$. The unit of time is one hundredth of a second. 


19 AS=INKEYS(599) Will wait 5 seconds for a key to be pressed. 

The command *FX 15,1 will flush the keyboard buffer. 

PRINT FORMATTING 

The first item is printed in a field 19 characters wide. Numeric variables 
are right justified in the field, string variables left justified. If the 
first item is numeric it can be forced to the left hand margin by a semi-colon 
before the numeric item. See examples 5 and 8 below. 

A comma between items to be printed continues to print items in fields 19 
characters wide. The number of fields will depend on the current mode, e.g. 
fields start at columns 1, 11, 21, 31 for mode 7 and columns 1, 11 for mode 5. 


A semi-colon between items prints items packed close together. 


A semi-colon at the end of the line makes the next print line continue on the 
same line. 


@% allows the field width to be changed and the number of decimal places 
specified, for example @%=&29309 specifies a field width of nine characters 
and three decimal places. The instruction can be broken up as follows. 


& ~- hexadécimal numbers follow 


2 - format 2 for fixed decimal places (1 for exponential, Ø for default) 
93 - number of decimal places, maximum 9 
09 - field width 
@% = 1@ returns to default value, format Ø and field width 19 
format Ø gives significant figures rather than decimal places 
format 1 gives figures as exponential values 


Statement Display (AS$="POLY",A=5.6) 


PRINT AS 


PRINT A 5.6 

PRINT AS,A,AS POLY 5. 6POLY 
PRINT A,AS,A 5. 6POLY 
PRINT;A,AS,A 5.6 POLY 
PRINTAS;A;AS POLYS. 6POLY 

PRINTA;A$;A 5. 6POLY5.6 
PRINT;A;AS;A 5. 6POLY5.6 

MODE 7 


@%=&20208:PRINT A,A 
@%=629396:PRINT A,A 


5.69 5.60 
5.600 5.600 


TAB(X) will move the cursor forward to column X on current line or next 
line down 
TAB(X,Y) will move the cursor to character position X,Y on the screen 


Superimposed characters 


Characters can be superimposed on each other to generate special effects and 
characters, such as circumflex accents or true underlining. See Chapter 19 of 
the BBC manual. 


Cursor control 


Either VDU N or CHR$(N) can be used to move the cursor about the screen and 
clear the screen. See Section 19 for VDU codes. 


The PRINT TAB(X,Y) to position the cursor is equivalent to VDU 31,X,Y. 


Cursor OFF - VDU 23;8202;0;0;8 

(VDU 23,1,9;8;8;8 version 1.6) 
Cursor ON - MODE statement 

(VDU 23,1,1;8;0;8 version 1.0) 


SCREEN DISPLAY, MODES, AND MEMORY USAGE 


Line/screen| Chars/screen | No of Resolution | Screen Memory 
line colours usage 


very high | 646x256 
A high 329x256 
16 med 160x256 
text - - 
2 high 320x256 
4 med 160x256 
text - = 
teletext | - - 


1 
2 
3 
4 
5 
6 
1 


Note: 
Model A has only modes 4 to 7 available. 
Home position 


Text - (0,6) at top left of text area 
Graphics - (0,8) at bottom left of graphics area 
horizontal, X-axis, @-1279 
vertical, Y-axis, -123 


Line length 


Computer accepts up to 238 characters for one program line. To enter more 
than the width of a screen line, carry on typing at end of line without 
pressing the RETURN key. 


GRAPHICS AND COLOURS 
Monochrome monitors and television sets 


If a monochrome monitor or television is used then a call to select a 
different colour will produce different shades of the default colour, 


Window setting 


A graphics window is set up with: 
VDU 24,left X;bottom Y;right X;top Y; 


where X,Y are graphics positions of the corners relative to the graphics 
origin. 


A text window is set up with: 
VDU 28,left X,bottom Y,right X,top Y 


where X,Y are the character positions of the corners relative to the text 
origin. 


Mode 7 


Mode 7 uses standard teletext control codes to change colours, i.e. different 
codes and statements from those available in modes @ to 6. Mode 7 allows 
limited but full colour graphics with economical use of memory. To change the 
colour of the text or background the control code must be sent via a-.PRINT 
CHRS(X) or VDU statement. The colour command is effective for that line 
only, each new line reverts to the default white on black background. 


Colour of Default for red 
characters function key 


red 
green 
yellow 
blue 
magenta 
cyan 
white 
flash on 
flash off 
double height off 

double height character, must repeat program line 

colours as 129-135 for alternative lower-case graphic shapes 
new background 


Modes Ø to 6 


The following keywords are used in producing high resolution graphics effects, 
MODE, GCOL, DRAW, MOVE, PLOT and VDU. 


PLOT K,X,Y is a multi-purpose point, line, and triangle drawing statement. 
X,Y are the co-ordinates of the destination point and Kis the manner of 
plotting. 


K 
D move relative to the origin 
L draw line from the origin to X,Y in current graphics foreground 
colour 
2 as 1 but in logical inverse colour 
3 as l but in current graphics background colour 
4 move from last position to X,Y. Equivalent to MOVE. 
5 draw line from last position to X,Y in current graphics foreground 
colour. Equivalent to DRAW. 
6 as 5 but in logical inverse colour 
7 as 5 but in current graphics background colour 
$-15 as Ø-7 but with the last point in the line omitted in “inverting 
actions’ 
16-23 as $7 but with a dotted line 
24-31 as 16-23 but without last point on line 
32-63 reserved for Graphics Extension ROM 
64-71 as $7 but only a single point is plotted 
72°79 reserved 
80-87 as @7 but plot and fill triangle formed between last two points 
visited and point X,Y. PLOT 85,X,Y is the standard call. 
88-255 reserved for future expansions 


Position of origin may be changed using VDU 29. 


To print a string at a specific screen position use TAB(X,Y) or join the 
graphics and text cursors with VDU 5. 


Logical inverse colours 


No of colours Logical Inverse 
2 V 1 
4 ) 3 
t 2 
2 d 
3 9 
16 H 15 
1 14 
15 H 


10 


Colour selection 


The normal colours for foreground and background for the different modes are 
shown in the table, they are known as the logical colours. The logical colour 
to be used is selected with the COLOUR X command, e.g. COLOUR 1. The sixteen 
possible colours are Ø to 15 of mode 2 and any logical colour may be changed 
by a VDU 19 statement to one of these actual colours, 


VDU 19, logical colour, actual colour, Ø,Ø,Ø or "8: 


MODE 5: VDU 19,1,4,0,8,@ or VDU 19,1,4;8; would change the default red 


foreground to actual colour 4, blue. 


When 


GCOL X,Y where 


Background(X) 


Li ba Pi 


H 
1 
2 
3 
4 
5 
6 
7 
8 
9 


selecting the colour for the graphics 


Y is the logical 


and X is @ to 4, as below: 


Fun-e8 


plot the colour specified 


OR the colour specified with that already there 


background 
method of placing the colour on the screen is also specified. 


black 
white 


black 
red 
yellow 
white 


black 
red 
green 
yellow 
blue 
magenta 
cyan 
white 
flashing 
flashing 
flashing 
flashing 
flashing 
flashing 
flashing 
flashing 


AND the colour specified with that already there 
Exclusive-OR the colour specified with that alrgady there 


invert the colour already there 
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or 


black-white 
red-cyan 
green-magenta 
yellow-blue 
blue-yellow 
magenta-green 
cyan-red 
white-black 


foreground, the 


colour, >127 defines the background colour, 


1@. VDU CODES AND CONTROL CHARACTERS 


VDU statements are used to generate ASCII control codes which are interpreted 
by the VDU drivers to give easy access to text and graphics facilities from, 


for example, BASIC and assembler programs alike. 


In direct mode the same effect can be produced by pressing the CTRL k 
the specified key. 


ey and 


Effect 
g does nothing 
A 1 send next character to printer only 
B 2 enable printer, send output to screen and printer 
C 3 disable printer, output to sereen only 
4 write at text cursor in normal fashion. MODE has same 
effect. 
5 graphics cursor only active. Text and graphics window in 
graphics colours. Screen does not scroll. 
6 re-enable VDU drivers after disabling with VDU 21 
G F make short "beep" sound 
H 8 cursor left one position 
I 9 cursor right one position 
| d 10 cursor down one position 
K 11 cursor up one position 
i L 12 clear screen and home text cursor. CLS has same effect. 
i 13 carriage return to start of current line 
I N 14 page mode, e.g for long listings, SHIFT for next page 
Z © 15 page mode off i 
| 16 clears the graphics area of the screen. CLG has same 
| effect. | 
i tT define text colour. COLOUR has same effect. 
| 18 define graphics colour. GCOL has same effect. 
| 19 redefine logical colour 
he 20 restore default logical colours 
ie Ul delete whole of current line 
f 21 stop further output to screen, e.g hide password, VDU 6 
re-enables 
l 22 select screen mode. MODE has same effect except VDU 22 does 
d not reset HIMEM. 
23 reprogram display character. Not available for use in mode 
7. VDU 23 can also be used to alter contents of 6845 CRTC 
circuit. 
24 define graphics window giving co-ordinates of four boundary 
points 
25 identical to PLOT. Use VDU 25 for machine code graphics. 
H 26 restore default windows and home cursor 
27 does nothing 
28 define text window 
29 define graphics origin 
© 30 home text cursor to top left of text area 
31 move text cursor to X,Y 
32-126 full set of letters and numbers in ASCII set 
Lët backspace and delete, same effect as DELETE key 
128-223 | undefined 
224-255 | available for user-definition using VDU 23 
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ll. 


12. 


USE OF PRINTER 
1) Connect printer to computer 


2) *FX 5,1 if using parallel printer (identified by flat ribbon of wires to 
printer) 


*FX 5,2 if using serial printer (identified by single flex to printer) 
default is parallel printer (i.e. no need to include *FX command) 


If serial printer selected, transmit baud rate to match that of the 
printer with a *FX 8,N command, where N is in range 1 to 8. 


1-75, 2-150, 3-300, 4-1200, 5-2490, 6-4800, 7-9600, 8-19290. 
3) *FX 6,n is used to suppress the sending of particular characters, such as 
line feed, to the printer. The default is FX 6,19 to ignore line feeds, 


FX 6,9 to reset to no suppression. 


4) CTRL B (or VDU 2) to enable the printer, CTRL C (or VDU 3) to disable the 
printer. 


Example set up for EPSON printer 


SEX 5,2 select serial interface printer 
XFX 8,4 select transmission rate of 1209 baud 
*FX 6,0 for the EPSON - this may or may not be needed for your printer 


Followed by VDU2 to enable the printer and, when finished, VDU3 to disable the 
printer. 


Other useful commands might be VDU 1,15 for condensed characters and VDU 1,18 
to cancel condensed characters. VDU 1,14 produces enlarged characters for one 
line only, but may be cancelled in mid-line with VDU 1,29. 


USE OF DISK DRIVE 


All the disk filing system commands are prefixed with a * and are included in 
alphabetical order in Section 13. 


Instructions for loading and ruining a program already on disk are given in 
Section 2. The commands are LOAD"<filename>" then RUN or CHAIN’<filename>” to 
load and run the program. 


Formatting a new disk 


A new disk requires formatting before it can be used to store programs or 
data. This process includes setting up the track and sector format on the 


disk and creating a catalogue. í 


The disk itself is the same for whichever disk unit you use. 
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This section will refer to formatting on the CUMANA drive units. The disk can 
be formatted with either 4@ or 8@ tracks. Each track has 1% sectors which can 
each hold 256 bytes of information, The single drive unit can only handle a 
49 track format but the double drive unit can handle either the 4@ track or 
more compact 8@ track. In addition, the double drive unit can handle disks 
formatted on both sides. 


In the dual drive unit the drives will be nunbered Ø and 1 for single side 
format disks. Each side of a double side format disk will be given a drive 
number, H and 2 or 1 and 3. 


To format a disk you will require both a new disk and also a disk carrying the 
format program, for example a UTILITIES disk. For a single drive unit, insert 
the UTILITIES disk in the drive and type: 


* FORMY Ø 


TAKE THE UTILITIES DISK OUT OF THE DRIVE and insert your new disk into the 
drive. The progress of the formatting procedure is shown diagrammatically on 
the screen. When formatting is complete the option is given to format another 
new disk before leaving the format program. 


For a double drive unit the UTILITIES disk must be inserted into drive Ø and 
the option is given to choose which drive you wish to format (Ø to 3). Use 
the command *FORM8@ for the 8@ track format. 


Catalogue 


SCHT will list the catalogue of files on the current drive or the one 
specified, e.g. *CAT 1. The catalogue on a disk can be divided into 
independent directories. Files of the same name can be held on the same disk 
by putting each into a different directory. Each directory is identified by a 
single character, e.g. Aor X. The default directory is $. 


The catalogue listing shows the current directory file names first. The files 
on the other directories follow, each prefixed by its directory character, 
e.g. A.PHOTO. An L after a filename signifies that the file is locked. The 
catalogue heading shows the disk name, drive logged on to, drive and directory 
being accessed, and the option set for autostart. 


At switch on, or after BREAK is pressed, the current drive defaults to Ø and 
the directory to $. Use *DRIVE and *DIR commands to log onto a different 
drive and/or directory. 


When a program is saved it is automatically saved on the current drive and 
current directory unless the change(s) is shown in the filename specification, 
e.g. SAVE ":1.A.PHOTO", 


Keep utility programs such as FORM4Ø, sort programs etc together in one 
directory, referred to as the library directory. Utility programs are often 
in machine code and usually only require a *<filename> command to run them. 
See the BBC manuals for information on saving and running machine code 
programs. 
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File specification 
The full file specification is: 


:<drive>.<directory>.<filename> 
For example: 
CHAIN" :@.L.WAGES" 


If the drive is not specified then the current drive is assumed, Ø at switch 
on. If the directory is not specified then the current directory is assumed, 
$ at switch on, The filename can be made up of up to 7 characters but not 
including : . # or * or embedded spaces. If an embedded space is included, 
only the characters as far as the space are used. # and * are used when 
wanting to specify a group of files, the * being used to replace several 
letters or # to replace just one letter. 


For example: 


#INFO :@.#.WAGES will search all the directories on drive Ø and display 
information about amy file called WAGES. 


*®INFO :Ø.$.WA* will search the $ directory on drive Ø and report on all 
files whose names begin WA. 


*INFO :1.$.#AG* will search the $ directory on drive 1 for all filenames 
whose second and third letters are AG. 


! BOOT 


A disk may be set up with an autostart facility such that, when the SHIFT key 
is held down and the BREAK key pressed briefly, a particular program on the 
disk will automatically load and run. DO NOT RELEASE THE SHIFT KEY BEFORE THE 
BREAK KEY. 


The instructions for the autostart are contained in a file called !BOOT which 
may be either a machine code or *EXEC file. For example, the WELCOME disk 
uses a !BOOT file to CHAIN the introductory program. A !BOOT file such as 
this can be created using the *BUILD command. The action initiated by the 
autostart is set with the OPT 4,n command at the time of creating the !BOOT 
file. 


where n=@ !1BOOT is ignored (default) 
n=1 *LOAD !BOOT in memory 
n=2 *RUN !BOOT as a machine code program 
n=3 *EXEC !BOOT 


The option set is shown in the catalogue heading of that disk, by default it 
is set to Ø to ignore (BOOT, ' 


Copying, renaming, and removing programs 


#COPY <source drv><dest drv><filename> will copy a program from one drive to 
another. 

*COPY Ø 1 WAGES will copy the program WAGES on drive Ø to drive 1 

*COPY Ø 1 * will copy all programs on drive Ø to drive 1 

CAUTION the COPY programs may overwrite the contents of memory so save your 

current program before using *COPY. 


*BACKUP<source drv><dest drv> is a sector by sector copy program for dual or 
single drive disk units. 

*BACKUP must be preceded by *ENABLE 

*BACKUP Ø Ø will create a backup on a single drive unit, instructions are 
given as it runs 

*BACKUP 1 Ø will create a duplicate on drive Ø of the disk in drive 1. 

CAUTION as for *COPY 


*RENAME <old filename><new filename> will change the filename and, if 
requested, move it to another directory on the same disk. 

*#RENAME WAGES B.PAYSLIP will rename WAGES as PAYSLIP and move it to directory 
B 


*DELETE <filename> will remove a single named file from the catalogue of a 
disk. 

*DESTROY <matchname> is used to remove a group of files in one operation from 
a disk. The command must be preceded by *ENABLE. 

*WIPE is used to remove a group of files one at a time, confirmation is sought 
for removing each one. 

*DELETE, *DESTROY and *WIPE will not remove locked files. *ACCESS is used to 
lock or unlock a file. 


VOCABULARY 
All keywords must be in capital letters. 


If a BASIC word starts with a * then the whole of the rest of the statement is 
passed to the operating system directly. 


Many of the commands have permissible abbreviations which are listed in the 
manual. The abbreviations which are likely to be of most use are: 


5. for *CAT 
L. for LIST 
P, for PRINT 


[ ] enclose optional items 


0% =&2 9209 


PURPOSE 


Change default width of print 
field and specify number of 
decimal places. See Section 7. 


19 A=ABS(B) Absolute value of B (ignores 


sign). 
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KEYWORD 


*ACCESS 


EXAMPLE PURPOSE 


* ACCESS WAGES L 
* ACCESS WAGES 


1Ø X=ACS(Y) 


67@ X=ADVAL(3) 


995 TEMP=ADVAL(X) 


X=ADVAL(Ø) 


X=ADVAL(-1) 


18 A=ASC(B$) 


Ou ANGLE=ASN(Y) 


9% X=ATN(2.31) 


AUTO 


AUTO, 158 
AUTO,56,5 


18 ANGLE=DEG(ACS(@.5678)) 


IF X=5 AND Y>@ THEN--- 


9@ X=DEG(ASN(@. 3456) ) 


Locks or unlocks a named file to 
prevent it being deleted or 
overwritten. 

Locks the file WAGES, 

Unlocks the file WAGES. 


Arc-cosine, calculates the angle 
(in radians) whose cosine is 
known. Convert radians to 
degrees with function DEG, 


Analogue to digital converter 
value. 

Returns the last known value of 
the analogue to digital channel 
specified in brackets. Channels 
1 to 4. 

Special function to test which 
FIRE button pressed on games 
paddle. 

Negative argument in range -1 to 
-7 tests various internal 
buffers in computer. 


Use as logical operator, both 
conditions must be met or 
bit-wise comparison of two 
numbers. 


Returns integer value 
corresponding to the ASCII code 
of the first character in B$. A 
null string returns the value 
EAR 


Arec-sine. Calculate the angle 
in radians whose sine is known. 


Arc-tangent. Calculate the 
angle in radians whose tangent 
is known, 


Automatically generates program 
line numbers. 

Start at line 1%, ascend in 
steps of 16. Highest line 
nunber 32767. Press ESCAPE to 
leave AUTO. 

Start at line 150, steps of 10. 
Start at line 58, step 5. 


EXAMPLE PURPOSE 


#ENABLE 
*®BACKUP<sdr> <ddr> 


* BACKUP Sector by sector copy program. 
The *ENABLE command must precede 
the *BACKUP. 

To copy the disk in drive @ on 


to the disk in drive 1. 


#BACKUP Ø 1 


# BACKUP Ø @ To make a backup copy using a 
single drive unit. Instructions 


given as backup proceeds. 


11@ Y=OPENIN" RESULTS" 
12@ CHAR=BGET#(Y) 


Reads a single (byte) from a 
file on cassette tape or floppy 
disk on channel allocated. The 
file must have been previously 
opened with OPENIN command. 


126 X=OPENOUT" RESULTS" 
330 BPUT#Y, 32 


Writes a number (byte) to a file 
on cassette tape or floppy disk 
on channel allocated. File must 
have been previously opened. 

The number must be in the range 
Ø to 255. Numbers larger than 
256 will be brought to within 
required range by repeated 
subtraction of 256. For large 
numbers use PRINT#. 


Creates a file directly from the 
keyboard. After typing the 
command, everything else entered 
will go into the named file, 

! BOOT. Line numbers 
automatically displayed on 
screen. Use ESCAPE key to 
terminate *BUILD. 


*BUILD *BUILD !BOOT 


Transfer control to a machine 
code subroutine. Parameters, 
e.g. J, K, L, can be passed. 


5@ CALL small,J,K,L 


Displays catalogue of files on 
cassette/disk/net. Can be used 
to.verify a program just saved 
on tape, see Section 2. 

Displays catalogue of files on 
disk in drive 1. See Section 12 
for more information. 
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KEYWORD EXAMPLE 


CLOSE# 


CLG 


COLOUR 


15@ CHAIN"UNIT2" 


500 CHAIN"" 


1M A$=CHR$(34) 


11M PRINT CHR$(13) 


998 CLOSE#5 
998 CLOSE#@ 


556 CLG 


560 CLS 


MODE 5:COLOUR 1 


COLOUR 129 


*COMPACT 1 


PURPOSE 


Enables one program to load and 
run another program 
automatically. Clears all 
variables except @% and A% to 
Za. * 
| Will load and run program called 
"UNIT2" from tape or disk. 
Will load and run the next 
program on cassette tape. 


Returns as a string the ASCII 
character with the numeric value 
specified, in this case ", 
Prints the character with the 
ASCII code specified, in this 
case a carriage return. (See 
VDU also.) 


Resets all the variables to Ø or 
null except for the resident 
integer variables A% to Z%. 


Close file 5. 
Will close all files. 


Clears the graphics screen 
leaving background colour as 
selected by GCOL. Move cursor 
to home position (9,8) at bottom 
left of graphics area. 


Clears the current text area 
leaving background colour as 
selected by COLOUR. Move cursor 
to home position (0,8) at top 
left of current text area. 


To change the colour of the text 
to selected number. 

To change the colour of the 
background. See separate table 
for colour possibilities. 


Moves all available space on a 
disk into one continuous block 
following the current files. 
Particularly useful if disk 
nearly full. 

WARNING This command may 
overwrite the contents of 
memory; save program or data in 
memory before issuing the 
command. 


KEYWORD EXAMPLE PURPOSE 


*#COPY Ø 1 WAGES Copy the file WAGES from drive @ 
to drive 1. 

WARNING This command may 
overwrite the contents of 
memory. 


19 A=COS(B) 
11 A=COS(RAD(45) ) 


Cosine of B. B must be in 


radians, 


119 A=COUNT 
PRINT COUNT 


Returns the number of characters 
printed to screen, printer etc. 
since the last new line. 


DATA 2,FRED,ERIC 
DATA " JONES" ,"SMITH,D," 


Specifies data to be accepted by 
a READ statement. Strings only 
need to be delimited by " if 
they contain leading spaces or | 
commas. If data is text where | 
numeric data was expected, then 
@ returned. 


9090 DEF FNVAT(g)=1. 15%g Defines function or procedure 
230 PRINT FNVAT(P) which can then be called by 
name. Multiple line definitions 
possible, last line of function 
starts with =, last line of 
procedure is ENDPROC. 


DEG 


190 X=DEG(1. 36) Converts angles expressed in 


radians to degrees. 


DELETE Direct command to delete the set 
of lines specified. 

Deletes lines Ø to 6@ inclusive. 
Will delete line 5600 to end as 
32767 highest possible line 
number. 


DELETE 0,68 
DELETE 5600 ,32767 


*DELETE *#DELETE FRED Removes file FRED from current 


directory on current drive. 


*DESTROY Used to destroy a group of files 
on a disk. 

*ENABLE required before 
*DESTROY. 

Will destroy any files with 
filenames containing the 
substring .H, e.g. A.HELLO 


* ENABLE 


*DESTROY $. HR 
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KEYWORD EXAMPLE PURPOSE 


DIM CODE(19d) ,PA$(28) Specifies maximum size of 

DIM NAME$(4, 15) arrays, single or 
multidimensional. First element 
in array is numbered @, no 
maximum within bounds of memory. 
DIM statement initialises 
numeric array variables to Ø and 
strings to null strings. 

DIM X 24 DIM can also be used to reserve 

| bytes in memory for special 
applications. In example 
reserves 25 bytes at address X. 


To change the current directory 
to <dir>, in this example A. 
The current disk directory is 
always set to '$' when BREAK is 
pressed. 


*DISC Select disk file system for file 
*DISK | *DISK operations such as LOAD and | 
SAVE. | 


DIV 12øØ XX=2ØDIV 3 Returns the whole number part of! 
the result of a division. | 


56@ DRAW X,Y In modes Ø, 1, 2, 4 draws a line} 
| from current point to point 


| given by co-ordinates X,Y in 
current foreground colour. 


*DRIVE į *DRIVE 1 Sets the current drive to drive 
Le 
Sets the current drive to drive 


g. 


*DRIVE Ø 


| 
| 
| 


*DUMP ` *DUMP TESTA Produces a hexadecimal listing 

f of the named file on the screen.. 
Must be given immediately before 
the *BACKUP or *DESTROY commands 
to prevent them being used 
accidentally. 


# ENABLE i *ENABLE 


1500 END Optional end-of-program 
statement, use wherever and 


whenever required. i 


Final ‘statement of PROCEDURE 
definition. 


ENDPROC . 1900 DEF PROCFIG(K) 


: 1998 ENDPROC 
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EXAMPLE PURPOSE 


Used with the SOUND statement to 
control the volume and pitch of 
a sound. 14 parameters 

required, see manual. 


ENVELOPE 


106 X=EOF#(N) 
206 REPEAT UNTIL EOF#(N) 


Returns -1 if end of file 
reached otherwise returns Ø. N 
is the channel number. 


200 R=X EOR Y 


Performs the operation of 
logical bitwise exclusive-or 
between the two operands. 


Returns the line number of the 
line where the last error 
occurred. 


8580 X=ERL 


168@ WRONG=ERR 
108 IF ERR=17 THEN--- 
PRINT "YOU CANT ESCAPE!" 


Returns the error number of the 
last error which occurred. 


12 A$="X 24X-3" 
2@ FOR X=1 TO 5 

3Ø Y=EVAL(A$):PRINT Y 
| 4Ø NEXT X. 


Allows the user to input, e.g. a 


mathematical expression into a 
string (A$). EVAL passes the 
function into the program. 


#EXEC" SHORT" Used to merge the program 
"SHORT", previously saved by 
*SPOOL, into the currently held 


program. 


EXP 19 AsEXP(B) Returns value of ef. 


EXT # 109 X=EXT#(employ) Returns the length in bytes of 
the file opened on channel 
given. For use with disc and 


network file system only. 


Returns the value @ if statement 
is not true. Numerical value of 
FALSE is Ø. 


FALSE PRINT 5=4 
245 UNTIL FALSE 
28 CLOCKSET=F ALSE 


Reserved word used at start of 
all user-defined functions. 


FN 1900 DEF FNVAT(g)=1. 15¥*g 


FOR-=NEXT 12 FOR X%=1 TO 5 Perform the block of 
D instructions between the FOR and 
52 NEXT X% NEXT statements. Step is 
H default of 1 unless specified. 
FOR--STEP-— 73 FOR X=5 TO 1 STEP-.5 Integer control variables are 
NEXT $ faster than real control 


98 NEXT X, variables. 
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PURPOSE 


KEYWORD EXAMPLE 


*FX9,19 Used to control a large number 
*FX21,0 of the computer's special 

#FX8,4 effects such as flashing colours 
or flushing buffers. See manual 
for details and Section 11 for 
use of printer. 


100 GCOL #,2 Select colour to be used by 
GCOL 3,129 subsequent graphics operations. 
First number specifies mode of 
action, second the colour. See 
Section 9. 


1949 keybit=GET Waits for a key to be pressed 
35@ X=GET and returns ASCII number of key 
pressed. Does not display 
character key pressed. 


1956 A$=GET$ Waits for a key to be pressed 
2018 IF GET$="Y"THEN--- then returns string containing 
the character. Does not display 
character key pressed. 


119 GOSUB 35¢ Execute subroutine which starts 
at line 358. Maximum nested 
depth is 26. 


GOTO 180 Start program at line "180 | 
without destroying values 
assigned to the variables. 
11@ IF---THEN GOTO 360 Transfer control to a specified 

118 GOTO (X#*5+2) or calculated line number. 


*HELP DFS Will list the disk filing system 
commands, 

*HELP UTILS Will list the disk utilities 
available. 


100 HIMEM=H IMEM—4 6 HIMEM contains the address of 
190 PRINT HIMEM + the first, byte that BASIC does 
not use. 


IF --THEN-- 190 IF Y THEN A=B If test condition true then do 
150 IF X$="Y"THEN 458 whatever follows. If test 

IF --THEN-- 158 IF X$="Y"THEN--- condition not true then either 
ELSE-- 168 ELSE--- perform the ELSE statement if 
present or drop through to the 
next line. 
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EXAMPLE ` 


*INFO A.HELLO 


Display detailed file 
information in following order: 
directory, filename, access, 

load address, execution address 
length in bytes, start sector. 


199 NUM=INKEY(X) 1) Waits a specified time (X) 
for a key to be pressed, 
then returns ASCII value of 
key, if no key pressed 
returns -l. X measured in 
hundredths of a second. 

*FX 15,1 to flush the 
buffer. 

2) INKEY with negative number 

checks for a particular key, 

example is testing for key 

L. 


IF INKEY(-87)THEN--- 


INKEY$ 129 LTS=INKEYS$(X) 


129 RSTS=LNKEY$(19@) 


Waits a specified time for a key 
to be pressed then returns key 
character pressed in a string 
variable. If no key pressed 
returns null string. X measured 
in hundredths of a second. 

*FX 15,1 to flush the buffer. 


INPUT Used to request input from the 


user. 


INPUT LINE 


See Section 6 for details. 


LNPUT# INPUT#X ,A, BS 


Used to read data back into the 
computer from cassette or disk. 
X is channel number. 


INSTR Lë X=INSTR(AS, BS, Z) 
19 X=INSTR("HOUSE” ,” OU") 
1 X=INSTR(A$,"0U",3) 


Returns the start position of a 
substring (B$) within a string 
(AS). Ø is returned for no 
match. 1 is returned if 
searching for null string. 
Starting position (Z) of search 
may be specified. 


INT Converts a real number to the 
lower integer. 
Returns 3. 


Returns -4. 


159 X=INT(3.1) 
15@ X=INT(-3.1) 


*KEY Programs one of the user-defined 
keys. 
Will program key f2 to be 


“DATA”. 


*KEY 2 DATA 


eege, | 


PURPOSE 


| KEYWORD 


EXAMPLE 


18 A$=LEFT$(B$,C) 


Returns the C leftmost 
characters of the string B$. 
Would return "HO", 


18 A$=LEFT$("HOUSE" ,2) 


Returns the number of characters 
in a string. 


18 A=LEN(B$) 


18 X=X+6 The word LET is optional when 
or 1@ LET X=X+6 assigning a value to a variable. | 


Sets the drive/directory | 
containing the library of ! 
(utility) programs. | 
SLIR20t.A Sets the library to drive 1 j 
directory A. ! 


Direct command only, cannot be 
used in a program. 

LIST Lists current program. 

EIST 115 Lists line 115. 

LIST ,30¢0 Lists lines Ø to 300. 

LIST 38, Lists 290 to end. 


*LIST MYTEXT Displays the textfile MYTEXT on 
the screen with line numbers. 


LISTO affects the print format 
produced by subsequent LIST 
commands. 

Allows insertion of spaces: 

a) after line number 

b) during FOR--NEXT loops 

c) during REPEAT--UNTIL loops 
LISTO@ Ø - no inserted spaces 

LISTO1 1 - insert space after line 


number 
LISTO2 2 - FOR--NEXT loops 
LISTO4 4 — REPEAT--UNTIL loops 
Ø, 1, 2, 4 can be added to 
LISTO6 ? produce number in range Ø to 7 


for combined options. LISTOØ 
option advised when editing a 
file. 


100 X=LN( temp) Returns natural logarithm of 
| argument, 
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LOAD"STATS2" 


LOAD" HI 


LOAD ":1.A.WAGES" 


*LOAD"PROG"7E8G 


9@@ DEF PROCtriang (sz) 
9@5 LOCAL X1,X2,Y1,Y2 


955 ENDPROC 


180 X=LOG(Y) 


PRINT LOMEM 
LOMEM=TOP+& 109 


12 A$=MID$(B$,C,D) 


19 A$=MID$("HOUSE" ,2, 3) 
19 A$=MID$("HOUSE" ,2) 


PRINT 28 MOD 3 
PRINT 10.1 MOD 3.8 


1 MODE 5 
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Direct command to load the named 
program from tape, disk or 
network. Deletes current 
program, and clears all 
variables except A% to Z%. 

Will load the next program from 
tape only. See CHAIN for 
loading and running a program 
from within another program. 
Load WAGES from disk drive 1, 
directory A. 


Load a machine code program. If 
an absolute load address is 
given it will force the program 
to load at that address, 


LOCAL can only be used inside a 
function/procedure definition, 
LOCAL saves the values of the 
external variable names and 
restores these original values 
when function/procedure 
completed. 


Logarithm (base 1%) of Y. Anti- 
logarithms obtained by using 
Y=10+X. 


Start address for storage of 
variables other than A% to Z% 
and @%. Normally set to be the 
same as TOP. 


Returns D characters from B$ 
starting at C. 

A$="OUS". 

A$="OUSE". 


Returns the remainder after 
division of integer numbers, 
decimal numbers are truncated to 
integers. 

Would return 3. 

Would return 1. 


Clears the screen and sets up 
the mode specified. See 
separate section for details. 
Modes 4 to 7 only available on 
Model A computer. MODE cannot 
be changed inside a procedure or 
function. MODE resets the value 
of HIMEM. 


È 


*MOTOR *MOTOR Ø 


*MOTOR 1 


299 MOVE 159,509 
MOVE X,Y 


*NET 


19% FOR J=1 TO 19 


159 NEXT 


199 IF NOT(A=29 AND 
B=3) THEN 359 


OLD 


ON--GOTO-- 19% ON A GOTO 159, 


ON--GOSUB-- 259, 359 
ON ERROR GOTO 100 ON A GOSUB 1000, 
ON ERROR GOSUB 2600, 3000 


5ØØ ON ERROR GOTO 799¢ 


999 ON ERROR OFF 


OPENIN 59 X=OPENIN("TABLES") 


OPENOUT 79% X=OPENOUT ("TABLES") 
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EXAMPLE PURPOSE 


Used to turn the cassette motor 
relay on and off. @ for off. 


Moves the graphics cursor to a 
new position without drawing a 
line. 


Selects network file system for 
future file operations. 


Command to reset internal 
pointers and variables, except 
Ai to Z% and Bi, to a "no 
program present" condition. See 
OLD to recover the program. 


The closing statement of a 
FOR--NEXT loop. 


Reverses the condition of a 
test. See separate section for 
priority. 


Will retrieve a program after a 
NEW command or pressing the 
BREAK key provided no program 
lines have been entered or new 
variables created. Check first 
line number correct if > 255. 


Controls next line or subroutine 
to be executed depending on 
value of A. Value of A must 
range from 1 upwards in steps of 
l. If A outside range then 
execution drops through to next 
line. ELSE can be used to trap 
out-of-range values. 

Cancels the last ON ERROR GOTO. 


Opens a channel (X) ready for 
use to read data into the 
computer from the named file 
held on disk or cassette. While 
the file remains open the 
channel number is constant. 


Opéns a new file on cassette or 
disk ready to receive data from 
the computer. If a file of the 
same name exists it will be 

deleted then a new file of that 
name created. 


KEYWORD 


OPT 


*OPT 


, POS 


PRINT 


EXAMPLE ` ` 


200 OPT 1 
35@ OPT(pass*2+list) 


*OPT 1, X 


#OPT ty e 
*OPT 4, X 


19 IF A=20 OR B=3 
THEN 100 


10 PAGE=&5000 


2Ø PRINT “PAGE 
PRINT PAGE 


1Ø A=PI*Pt2 
PRINT PI 


1ØØg PLOT K,X,Y 


200 PLOT 6,100,280 


134@ colour=POINT(X,Y) 


75@ X=POS 
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PURPOSE 


Determines what output is 
produced on the screen when 
assembly language routines are 
processed by the BASIC 
interpreter. 


Enables a message system to 
display file information each 
time a disk file is accessed. 
1<X<99. 

Displays the message system. 
Changes the start-up option of a 
disk Ø<X<3. Ø does nothing, 1 
will LOAD !BOOT, 2 will *RUN 
!BOOT, 3 will *EXEC ! BOOT. 


Either condition may be met. 


PAGE gives start address of 
user's program in memory. Can 
be used to allow simultaneous 
Storage of two programs in 
different areas of memory. Use 
with care. 


The constant pi, 3.14159265. 


The multi-purpose point, line 
and triangle drawing statement 
in BASIC. K gives the manner of 
drawing to the point X,Y. See 
other section for possible range 
and effect of K. MOVE is 
equivalent to PLOT 4, DRAW is 
equivalent to PLOT 5. 


Returns the logical colour of 
the screen at the graphic point 
specified. If the point is off 
the sereen then the function 
returns -1. 


Returns the horizontal position 
of the cursor in the current 
text window. Range is Ø to 19, 
39 or 79 depending on MODE 
selected. 


The PRINT statement governs the 
display of material on the 
Screen, See Section 7 for 
details. 


KEYWORD EXAMPLE PURPOSE 


PRINT# 


PROC 


PTR# 


RAD 


READ 


REM 


* RENAME 


RENUMBER 


PRINT# X,A,B,C$ 


1® DEF PROCdraw 
166 PROCyear 


PRINT PTR#X 
560 PTR#FL=PTR#FL+88 


PRINT RAD(45) 


18 READ A, PR 
EET 62,"VAT" 
| 


| REM NOW CALC. AREA 


*RENAME SUMS B.ADD 


f 
H 
| 
H 


| RENUMBER 
RENUMBER Go 


RENUMBER "100,6 
| 
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Statement used to write data to 
a file on tape or disk. The 
file must have been previously 
opened using an OPENIN or 
OPENOUT statement. The channel 
number, X, must match that in 
the OPENIN statement. 


A reserved word used to prefix a 
procedure name. 


Pointer used to select an item 
to be read from a serial file. 
PTR# cannot be used with tape 
systems. 


Converts an angle measured in 
degrees to radians. 


Copies the next item from a 
data-list into the variable or 
variables which follow the 
keyword READ. The data type 
must match the variable type. 


Allows comments to be inserted 
into a program. The computer 


‘ignores any statement which 


begins REM. 


Changes the file name and moves 
it to another directory if 
required. 

The file $.SUMS becomes B.ADD 


Direct command to renumber the 
lines of a program. GOTO etc 
destinations will be amended 
accordingly. GOTO a missing 
line number will produce error 
message. It cannot handle 
calculated line numbers in 
ON-GOTO,. 

Will renumber from 18 in steps 
of 18. 

Will renumber from 5@@ in steps 
of 10. 

Will renunber from 198 in steps 
of 5, 


KEYWORD EXAMPLE PURPOSE 


REPEAT-~- 1 REM PRINT STARS Will repeat that program section 
UNTIL 20 NOW=TIME until the given condition is 
28 REPEAT PRINT"*"; met. Always executes once and 
4Q UNTIL TIME=NOW+16@ may be nested up to a depth of 


20. A single REPEAT may have 
more than one UNTIL. 


REPORT 5@@ REPORT Prints the error message 
associated with the last error 
condition, 

RESTORE 500 RESTORE Moves the data pointer back to 
the first DATA statement in the 

5@@ RESTORE 3500 program or to the DATA statement 
at the line given. 

RETURN 200 RETURN The word RETURN is used to 

500 IF X$="N"THEN signal the end of a subroutine 
RETURN section and returns the program 


flow to the statement after the 


GOSUB call. 
RIGHT$ 1@ A$=RIGHT$(B$,C) Returns the C rightmost 
characters of the string B$. 
18 A$=RIGHT$("HOUSE" ,2) Would return "SE", 
RND RND Generates ` random number in the 
range -2147483648 to 2147483647. | 
RND(1) Generates a number between Ø and | 
8.999999. | 
RND(@) Repeats the last random number | 
given by RND(1). | 
RND(X) Generates a number between 1 and 
X. 
RND(-X) Returns -X and resets the 
l generator to a number based on 
X. 
* ROM * ROM Selects ROM cartridge file 
system. 
RUN RUN Use in direct mode or program 


mode to make the computer 
execute the current program. 
All variables are reset except 
@% and A% to Z%. 


* RUN *RUN"match" Loads and executes a machine 


code program. Current directory 
searched first then library 
| directory. 
a a ee E oe SRE 
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KEYWORD 


SAVE 


*SAVE 


SGN 


SIN 


SOUND 


SPC 


*SPOOL 


SQR 


STEP 


STOP 


STR$ 


EXAMPLE PURPOSE 


SAVE"STATS/V1" 


SAVE A$ 


*SAVE"patch"6000 6200 


*SAVE"match"4C@@ 4CEQ 


A=SGN(B) 


10 A=SIN(B) 
119 value=SIN(RAD(45) ) 


SOUND A,B,C,D 


SOUND 1,-15,53,298 


PRINT A$;SPC(6);A 
INPUT SPC(1®); "VALUE" ,V 


*SPOOL "VERS1" 


A=SQR (B) 


99Ø IF X$="**"THEN STOP 


190 A$=STR$(B) 
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Saves current program with 
filename "STATS/V1" on cassette 
unit. The filename must start 
with a letter, maximum 19 
characters, no embedded spaces 
or punctuation marks. 


Save a section of machine code 
program at start address (SSSS), 
end address +1, (FFFF or length 
+LLLL). An execution address 
EEEE may be given otherwise 
taken as start address. 


Returns -1 if Bis negative, @ 
if Bis zero, or +1 if Bis 
positive. 


Returns sine of B, Bin radians, 
Use RAD to convert degrees to 
radians. 


Generates sound through internal 
speaker in accordance with 
parameters. A is sound channel, 
B is envelope number, C is 
pitch, and D is duration of 
note. 


Prints number of spaces 
specified in brackets to the i 
screen, Use only with PRINT and. 
INPUT. 


i 
1 
All material subsequently 
displayed on the screen, e.g. a 
program listing will also be 
written to the named file. 


Returns the square root of B. 


Part of FOR--TO--STEP---NEXT 
structure. STEP is optional, 
default value is STEP=1. 


Interrupts a program run and 
prints message STOP at line 
XXXX.; 


Converts a number into the 
equivalent string 
representation. STR$ is 
affected by the field width and 
format constraints set in @%. 


KEYWORD EXAMPLE PURPOSE 


STR ING$ 18 A$=STRING$(49," ") 
96 B$=STRING$(16,"*0") 


Produces multiple copies of a 
shorter string. 


TAB Move cursor forward to column X. 
On current line or next line 
down. 

Move cursor to character 


position X,Y on screen. 


96 TAB(X) 


90 TAB(X,Y) 


10 A=TAN(B) 
PRINT TAN(RAD(45) ) 


Returns tangent of B, Bin 
radians, Use RAD to convert 
degrees to radians. 


*#TAPE Selects the cassette filing 
system running at 1200 baud for 
future file operations, 

Select cassette filing system at 


300 baud. 


*TAPE3 


Used to set or read the internal 
timer which counts in 1/190 
second intervals. 


TIME=( (HO*69+mi) *6¢ 
+Se) #100 
410 nowtime=TIME 


*TITLE STITLE "DISKI" Changes the title of disk in 
current drive to "DISK1 mal 
Title is padded with spaces to 


| 
12 character length. | 
| 
| 
| 


200 PRINT TOP 
54Ø X=TOP 


Returns the first free memory 
location after the user's 
program. 


TRACE ON Causes the interpreter to 
display executed line numbers 
when it encounters them. 

Only line numbers less than 1900 


will be displayed. 


TRACE 1200 


TRACE OFF Turns trace mode off. 


300 UNTIL result=TRUE 
PRINT 4=4 


TRUE is represented by the value 
-1 in the computer. 


*TV 


Controls the vertical position 
of the screen display and the 
picture interlace. 


*TYPE MY PROG Lists the named file on the 


screen without line numbers. 


See REPEAT--UNTIL. 
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KEYWORD 


EXAMPLE 


1496 R=USR(&3 800) 


67@ result=USR(plot 5) 


A=VAL(B$) 


VDU 28,8,5,39,8 


VDU 24,6; 0; 1279; 830; 


VDU 2 


156 vert=VPOS 


100 WIDTH 35 


*WIPE $. Su 
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Function allowing machine code 
to directly return a value for 
problems which do not require 
the flexibility of CALL. 


Returns numeric value of string 
B$. If string not numeric then 
returns Ø. 


Used to generate a sequence of 
numbers that are then sent to 
the VDU drivers. Equivalent to 
PRINT CHR$ except that it does 
change value of COUNT. 

Would define a six line text 
window at top of screen — mode 5 
Would define a graphics area at 
bottom of screen and 838 points 
high. 

Turn printer on. 

See Section 18 for VDU codes. 


Returns the vertical position of 
the text cursor. 


Used to set the overall "page 
width", initially set to zero 
which the interpreter interprets 
as unlimited. Affects all 
output to the screen or printer. 
Forces a new line after 35 
characters printed. 


Removes specified files from the 
catalogue and rearranges the 
catalogue. Asks for 
confirmation before removing a 
file. 

Deletes all files on current 
drive beginning with the letters 
SU. 


14. ERROR MESSAGES 


When an error 


occurs the computer will print out an error message and set the 


two variables ERR (error number) and ERL (error line number). The message can 
be suppressed by using 


ON ERROR GOTO 900d 


and providing 


Special action routines starting at line 9090. Some of the most 


common error messages are listed below but the full list is given in the BBC 


manuals. 
No Me ssage 
10 Bad DIM 
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15 


Bad program 


Division by zero 


Failed at <line number> 


Mi stake 


No room 


No such variable 


Subscript 


Syntax error 


Comments 


An array must hold a positive number of 
elements. 


This is an untrappable error and is usually 
caused by a read error or by only loading 
part of a program or by overwriting part of 
the program in some way. 


Check any variables used as the division 
never have the value Ø. Note that when a 
variable is declared as LOCAL it is set to 
ø. 


Occurs when a program is renumbered and the 
original contains a destination line number 
which does not exist. 


The computer could not make any sense of 
the input line. 


All available memory used up. 


All variables must be assigned a value, or 
made LOCAL, before they can be used. Will 
also occur if illegal spaces included, for 
example TAB (1ø) instead of TAB(1Ø) will 
cause the computer to consider TAB a 
variable name, 


Occurs if the program tries to access an 
array element less then zero or greater 
than the range set in the DIM statement. 


A command was terminated incorrectly. 
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Common disk error messages 
Message 


Bad filename 


Disc full 


Dise fault NN at TT SS 


Not enabled 


File open 


Disk fault 18 at XX/XX 


Comments 


Invalid filename, maximum length is 7 
characters. 


Insufficient space on the disc to open or 
Save the specified file. DO NOT USE 
*COMPACT until the program in memory has 
been saved in some other manner as *COMPACT 
can corrupt the current program in memory. 


The computer cannot read the disk. The 
disk might be unformatted, damaged, write 
protected or of wrong type, or the disk 
drive might be faulty. 


The command *ENABLE must precede a *BACKUP 
or ®*DESTROY command 


File already open or trying to delete an 
open file. If a program under test crashes 
leaving one or more files open then a CLOSE 
Ø will close any files still open. 


Cumana double drive unit, switched to 8@ 
track for 4@ track formatted disk. 
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